strnicmp()              Compare n Characters of Strings, Case Insensitive

 #include   <string.h>                   Required for declarations only

 int   strnicmp(str1,str2,n);
 const char *string1;
 const char *string2;
 size_t     n;                           Number of characters compared

    strnicmp() is a case-insensitive version of strncmp(); it compares a
    maximum of 'n' characters of 'string1' to 'string2'.  The strings are
    compared lexicographically. Uppercase and lowercase forms of a letter
    are considered equivalent.

       Returns:     A value indicating the relationship between the two
                    strings:

                          Comparison          Returned

                    'string1' <  'string2'      < 0
                    'string1' == 'string2'        0
                    'string1' >  'string2'      > 0

         Notes:     strnicmp() expects to operate on null-terminated
                    strings.  No overflow checking is done when strings
                    are copied or appended.

   -------------------------------- Example ---------------------------------

    The following statements compare 'n' characters of two strings.  The
    strings are equivalent.

           #include <string.h>
           #include <stdio.h>

           char str1[20] = "eucalyptus trees";
           char str2[20] = "Eucalyptus Trees";
           int rslt;

           main()
           {
               if((rslt = strnicmp(str1,str2,strlen(str1))) == 0)
                   printf("strings are equivalent");
               else
                   printf("strings are not equivalent");
           }